<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      Colord-1.4.4
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-9.1">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 9.1
      </h4>
      <h3>
        Chapter&nbsp;12.&nbsp;System Utilities
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="bubblewrap.html" title=
          "Bubblewrap-0.4.0">Prev</a>
          <p>
            Bubblewrap-0.4.0
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="cpio.html" title="cpio-2.13">Next</a>
          <p>
            cpio-2.13
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="sysutils.html" title=
          "Chapter&nbsp;12.&nbsp;System Utilities">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 9.1">Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="colord" name="colord"></a>Colord-1.4.4
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to Colord
        </h2>
        <p>
          <span class="application">Colord</span> is a system service that
          makes it easy to manage, install, and generate color profiles. It
          is used mainly by <span class="application">GNOME Color
          Manager</span> for system integration and use when no users are
          logged in.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://www.freedesktop.org/software/colord/releases/colord-1.4.4.tar.xz">
                https://www.freedesktop.org/software/colord/releases/colord-1.4.4.tar.xz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: 32c2709a6002d9ee750483aaed6379c8
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 1.8 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 23 MB (with tests)
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 0.1 SBU (with tests)
              </p>
            </li>
          </ul>
        </div>
        <h3>
          Colord Dependencies
        </h3>
        <h4>
          Required
        </h4>
        <p class="required">
          <a class="xref" href="dbus.html" title=
          "dbus-1.12.16">dbus-1.12.16</a>, <a class="xref" href="glib2.html"
          title="GLib-2.62.4">GLib-2.62.4</a>, <a class="xref" href=
          "lcms2.html" title="Little CMS-2.9">Little CMS-2.9</a>, <a class=
          "xref" href="../postlfs/polkit.html" title=
          "Polkit-0.116">Polkit-0.116</a>, and <a class="xref" href=
          "../server/sqlite.html" title="SQLite-3.31.1">SQLite-3.31.1</a>
        </p>
        <h4>
          Recommended
        </h4>
        <p class="recommended">
          <a class="xref" href="gobject-introspection.html" title=
          "gobject-introspection-1.62.0">gobject-introspection-1.62.0</a>,
          <a class="xref" href="libgudev.html" title=
          "libgudev-233">libgudev-233</a>, <a class="xref" href=
          "libgusb.html" title="libgusb-0.3.3">libgusb-0.3.3</a>,
          <span class="phrase">and</span> <a class="xref" href="vala.html"
          title="Vala-0.46.6">Vala-0.46.6</a>
        </p>
        <h4>
          Optional
        </h4>
        <p class="optional">
          <a class="xref" href="../gnome/gnome-desktop.html" title=
          "gnome-desktop-3.34.4">gnome-desktop-3.34.4</a> and <a class="xref"
          href="../x/colord-gtk.html" title=
          "colord-gtk-0.2.0">colord-gtk-0.2.0</a> (to build the example
          tools), <a class="xref" href="libxslt.html" title=
          "libxslt-1.1.34">libxslt-1.1.34</a>, <a class="xref" href=
          "../pst/sane.html" title="SANE-1.0.27">SANE-1.0.27</a>, <a class=
          "ulink" href="http://www.argyllcms.com/">ArgyllCMS</a>, and
          <a class="ulink" href=
          "https://github.com/scop/bash-completion/">Bash Completion</a>
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/colord">http://wiki.linuxfromscratch.org/blfs/wiki/colord</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of Colord
        </h2>
        <p>
          There should be a dedicated user and group to take control of the
          colord daemon after it has started. Issue the following commands as
          the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">groupadd -g 71 colord &amp;&amp;
useradd -c "Color Daemon Owner" -d /var/lib/colord -u 71 \
        -g colord -s /bin/false colord</kbd>
</pre>
        <p>
          First, clean up about 100 warnings:
        </p>
        <pre class="userinput">
<kbd class="command">mv po/fur.po po/ur.po &amp;&amp;
sed -i 's/fur/ur/' po/LINGUAS</kbd>
</pre>
        <p>
          Install <span class="application">Colord</span> by running the
          following commands:
        </p>
        <pre class="userinput">
<kbd class="command">mkdir build &amp;&amp;
cd    build &amp;&amp;

meson --prefix=/usr            \
      --sysconfdir=/etc        \
      --localstatedir=/var     \
      -Ddaemon_user=colord     \
      -Dvapi=true              \
      -Dsystemd=false          \
      -Dlibcolordcompat=true   \
      -Dargyllcms_sensor=false \
      -Dbash_completion=false  \
      -Ddocs=false             \
      -Dman=false ..           &amp;&amp;
ninja</kbd>
</pre>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">ninja install</kbd>
</pre>
        <p>
          To test the results, issue: <span class="command"><strong>ninja -k
          2 test</strong></span>. One test, <code class=
          "filename">colord-self-test-daemon</code>, will fail. The test
          suite must be run after the package is installed, and the
          system-wide D-Bus Daemon must be running.
        </p>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <em class="parameter"><code>-Ddaemon_user=colord</code></em>: This
          switch is used so the colord daemon will run as an unprivileged
          user instead of the <code class="systemitem">root</code> user.
        </p>
        <p>
          <em class="parameter"><code>-Dvapi=true</code></em>: This switch
          enables building the <span class="application">Vala</span>
          bindings. Remove if you don't have <a class="xref" href="vala.html"
          title="Vala-0.46.6">Vala-0.46.6</a> installed.
        </p>
        <p>
          <em class="parameter"><code>-Dsystemd=false</code></em>: This
          switch disables support for <span class=
          "application">systemd</span> login in Colord applications.
        </p>
        <p>
          <em class="parameter"><code>-Dlibcolordcompat=true</code></em>:
          This switch enables building a compatibility library for older
          packages that use <span class="application">Colord</span>.
        </p>
        <p>
          <em class="parameter"><code>-Dargyllcms_sensor=false</code></em>:
          This switch disables the ArgLLCMS sensor driver. Omit if you have
          <a class="ulink" href="http://www.argyllcms.com/">ArgyllCMS</a>
          installed and wish to use it.
        </p>
        <p>
          <em class="parameter"><code>-Dbash_completion=false</code></em>:
          This switch disables Bash Completion support for Colord
          applications.
        </p>
        <p>
          <em class="parameter"><code>-Ddocs=false</code></em>: This switch
          disables building of documentation. Omit if you have <a class=
          "xref" href="gtk-doc.html" title="GTK-Doc-1.32">GTK-Doc-1.32</a>
          available.
        </p>
        <p>
          <em class="parameter"><code>-Dman=false</code></em>: This switch
          disables building of man pages. Omit if you have <a class="xref"
          href="../pst/docbook-utils.html" title=
          "DocBook-utils-0.6.14">DocBook-utils-0.6.14</a> available.
          Namespaced versions of the docbook-xsl stylesheets are also
          required.
        </p>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">cd-create-profile, cd-fix-profile,
              cd-iccdump, cd-it8, and colormgr</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">libcolord.so, libcolordcompat.so,
              libcolordprivate.so, and libcolorhug.so</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/usr/include/colord-1,
              /usr/lib/colord-{plugins,sensors}, /usr/share/color{d},
              /usr/share/gtk-doc/html/colord, and /var/lib/colord</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="cd-create-profile" name=
                    "cd-create-profile"></a><span class="term"><span class=
                    "command"><strong>cd-create-profile</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is the Color Manager Profile Creation Tool.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="cd-fix-profile" name=
                    "cd-fix-profile"></a><span class="term"><span class=
                    "command"><strong>cd-fix-profile</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a tool used to fix metadata in ICC profiles.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="cd-iccdump" name="cd-iccdump"></a><span class=
                    "term"><span class=
                    "command"><strong>cd-iccdump</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    dumps the contents of an ICC profile as human readable
                    text.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="cd-it8" name="cd-it8"></a><span class=
                    "term"><span class=
                    "command"><strong>cd-it8</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is the Color Manager Testing Tool.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="colormgr" name="colormgr"></a><span class=
                    "term"><span class=
                    "command"><strong>colormgr</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a text-mode program that allows you to interact with
                    colord on the command line.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libcolord.so" name="libcolord.so"></a><span class=
                    "term"><code class="filename">libcolord.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains the <span class="application">Colord</span> API
                    functions.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libcolordcompat.so" name=
                    "libcolordcompat.so"></a><span class="term"><code class=
                    "filename">libcolordcompat.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains legacy API functions for compatibility with
                    older applications.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libcolordprivate.so" name=
                    "libcolordprivate.so"></a><span class="term"><code class=
                    "filename">libcolordprivate.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains internal API functions for the programs included
                    with <span class="application">Colord</span>.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="libcolorhug.so" name=
                    "libcolorhug.so"></a><span class="term"><code class=
                    "filename">libcolorhug.so</code></span>
                  </p>
                </td>
                <td>
                  <p>
                    contains a simple display hardware colorimiter.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-02-18 14:50:03 -0800
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="bubblewrap.html" title=
          "Bubblewrap-0.4.0">Prev</a>
          <p>
            Bubblewrap-0.4.0
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="cpio.html" title="cpio-2.13">Next</a>
          <p>
            cpio-2.13
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="sysutils.html" title=
          "Chapter&nbsp;12.&nbsp;System Utilities">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 9.1">Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
